Rotinas e subcircuitos

Por meio deste módulo é possível criar e gerenciar o funcionamento de rotinas nos fluxos de circuito e sub-circuitos.

A rotina é uma sequência de ações que podem ser cadastradas em ambos processos, circuito ou sub-circuito. Obedece regras pré-definidas com cada componente cumprindo seu papel, assim, permite analisar variáveis que de acordo com uma condição, diferentes decisões podem ser tomadas.

Acesse: Senior X > Gestão Logística > Otimização Logística > Gestão de Pátio > Definições Principais > Circuito.

Você pode adicionar um novo circuito ou escolher um circuito já cadastrado e seguir o passo a passo.

1. Informe os dados do painel Dados Relacionados

Escolha a área de interesse a ao lado direito > botão Ações > Rotinas

Na tela que abre, use o botão Adicionar;
No campo Gatilho, escolha o momento em que o questionário será aberto (se na "Entrada" ou na "Saída");
- Entrada - quando adicionado o comando "confirmação de chegada"
- Em operação - quando adicionado comando operacionais dentro do pátio
Escolha a rotina da forma que achar mais relevante com o fluxo;
Clique em Avançar;
Se necessário, é possível realizar qualquer alteração pelo botão Ações > Editar.

2. Adicione Rotinas e Comandos

No painel Adicionar Comandos do lado direito da tela é apresentada uma paleta de comandos, onde será escolhido o tipo de rotina e o comando.

Tipo de Rotina

Clique na aba Tipos de Rotinas e escolha a opção fluxo automatizado, independentemente do tipo de gatilho ("entrada" ou "em operação"), a escolha do comando sempre será esta, pois, essa rotina automatiza o controlador executando as seqüências e comandos automaticamente;
Escolha a rotina da forma que achar mais relevante com o fluxo;
Uma vez escolhida arraste-a até o quadro de comando para a construção do fluxo;
Após o término clique em Salvar

Abaixo segue a descrição de cada tipo de rotina

Tipo de Rotinas	Descrição
	Automatiza o controlador executando as seqüências e comandos automaticamente; Rotina para execução de gatilho de entrada e em operação.
	Rotina de decisão; Por exemplo, a partir de uma questão definida pelo usuário/empresa pode-se definir rotinas conforme a seleção SIM para verdadeiro ou Não para falso.
	É uma rotina de decisão após um retorno do ERP; É adicionada após um comando "Aguarda processo do ERP"de forma a decidir qual rotina a ser executada pelo controlador caso retorno seja: Processado - segue para descarregamento, por exemplo. Rejeitado - não é aceito o recebimento desta mercadoria.
	Confere o peso capturado com a capacidade de carga do veículo (PBT - Peso Bruto Total). Se o peso aferido estiver de acordo com a capacidade do veículo o mesmo será liberado, caso o PBT do veículo seja ultrapassado o mesmo é direcionado para execução das rotinas no peso maior, porém se estiver dentro da tolerância é direcionado para as rotinas de peso menor ou igual.
	Rotina de decisão do retorno do sistema externo. É adicionada após um comando Aguarda Sistema Externo de forma a decidir a continuidade do fluxo com base na resposta recebida. Caso o retorno seja: Processado - segue para descarregamento, por exemplo. Rejeitado - não é aceito o recebimento desta mercadoria.

Tipo de Comando

Na mesma paleta de comando;
Na é apresentada uma paleta de comandos que podem ser escolhidos da forma que achar mais relevante com o fluxo;
Uma vez escolhido, arraste-o até o quadro de comandos para a construção do fluxo da rotina;
Após o término clique em Salvar.

Observação

Conforme o tipo de comando escolhido, outros campos são abertos automaticamente e devem ser habilitados para a configuração correta do fluxo da rotina.

Abaixo segue descrição de cada comando

Comandos	Descrição
	Esse comando deve ser sempre adicionado em rotinas de gatilho em operação e nos finais de cada comando, indicando a próxima sequência que o veículo deve passar.
	Utilizado em rotinas de decisão e em rotinas de gatilho em operação.
	Define que o veículo se encontra na área apropriada; Sempre usado em rotinas de gatilho de entrada.
	Adicionado como último comando da última sequência.
	Cancela as sequências do circuito e o agendamento.
	Cancela apenas as sequências do circuito executadas; O agendamento volta ao status agendado e pode ser iniciado novamente, a partir do controle de chegada.
	Normalmente utilizado para tomadas de decisão, onde o veículo necessita sair de uma sequência e ir para outra sequência do circuito; Pode ser usado em rotinas de condição, retorno de ERP ou validação de peso.
	Comando de retorno para o circuito inicial; Por exemplo, quando um veículo está alocado em um subcircuito, e ao validar o retorno do ERP com status "processado" o mesmo é enviado para o circuito inicial, caso "negado" continua no sub-circuito.
	Caso necessário dar uma pausa na rotina, é possivel aguarda ação do usuário para continuar a execução das sequências dos comando.
	Comando definido para informar ao gestor da fila onde será controlada a fila dos veículos; Normalmente adicionada no início da sequência.
	Informa o gestor da fila onde será o start da operação, ou seja, onde o veículo passar é confirmada em operação, desta forma indica ao gestor de fila que um determinado veículo confirmou a operação e deve sair da lista de chamada.
	Neste comando o veículo não será mais controlado pelo gestor de fila. É inserido nas última ou penúltimas sequências do circuito.
	Normalmente este comando compartilha informações com a cancela; Através de Integração com LPR é feita a captura da placa do veículo. O Gestão de Pátio valida as informações com agenda e se for a área correta o acesso é liberado
	Abre a cancela
	Fecha a canela
	Captura a imagem no decorrer da rotina
	Envia informações de agenda, fotos e peso para o ERP, com respectiva seleção de processo de informações como entrada ou saída.
	Aguarda o retorno do ERP, com as seguintes integrações: Pré-cadastro Classificação Carregamento Faturamento
	Este comando tem a finalidade de incluir a seleção de doca no circuito.
	Comando para interação com sistema terceiro que aguarda o envio dos eventos para dar a sequência no circuito. WMS: ao configurar o comando e selecionar o parâmetro Validar OR no campo Tipo de Processo, na execução do circuito, quando o comando travar devido ao status Sem condição da nota fiscal, será possível dar a sequência pelo botão de Avançar manualmente ou Reavaliar. Genérico: ao configurar o comando e selecionar o parâmetro Validar Questionário, é feita a validação do questionário atráves de um sistema externo.
	Comando para a inclusão de perguntas a serem respondidas durante a execução do circuito.
	Este comando é responsável pelo envio de e-mail.
	Este comando é utilizado para indicar se é o peso de entrada, de saída ou indiferente.
	Este comando possibilita gerar um documento em formato PDF.

O que mais você pode fazer:

Comando Aguardar Sistema Externo e sua integração via Webhook

O webhook é uma forma de conectar sistemas, enviando informações automaticamente quando um evento acontece.

Aqui no Gestão de Pátio, é utilizado no comando Aguardar Sistema Externo, dentro do Tipo de Processo Validar Questionário. Isso significa que a validação do questionário é realizada por um sistema externo, que recebe a notificação, processa as informações e retorna a resposta necessária para dar continuidade ao circuito.

Como visualizar as informações do questionário?

Para visualizar as informações inseridas no questionário, é necessário fazer uso da API:

URL:

https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/yms/patio/entities/circuitQuestionnaireView

Exemplo JSON:

{

"totalPages": 3,

"totalelements": 23,

"contents": [

{

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"execucaoCircuitoId": "string",

"sequenciaCircuitoId": "string",

"titulo": "string",

"pergunta": "string",

"resposta": "string",

"createdBy": "string",

"createdDate": "2025-01-09T14:06:02.899Z",

"lastModifiedBy": "string",

"lastModifiedDate": "2025-01-09T14:06:02.899Z"

}

No resultado do HTTP GET, existem dois atributos que informam a quantidade de registros e a quantidade de páginas.

totalPages: número de páginas existentes de dados, cujo valor é calculado dividindo-se o total de elementos pela quantidade de elementos por página. O valor será 10 quando o parâmetro size não é informado na URL;
totalElements: número total de registros retornado pela query executada.

Para definir quais registros serão retornados, use os parâmetros offset e size. O size indica a quantidade de registros na página, e o offset especifica o número da página a ser recuperada, lembrando que a numeração de páginas começa em 0 (zero).

Exemplo:

https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/yms/patio/entities/circuitQuestionnaireView?size=5

O resultado será 5 registros por página e o totalPages será igual a 5.

Exemplo:

https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/yms/patio/entities/circuitQuestionnaireView?size=5&offset=2

O resultado será 5 registros da página 2.

Requisição com ordenação

Para fazer uma requisição com ordenação, adicione o parâmetro orderby à URL, seguido de um sinal de =, e após um ou mais atributos da entidade pelo qual deseja-se fazer à ordenação:

Atributo padrão:

https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/yms/patio/entities/circuitQuestionnaireView?orderby=titulo

Caso haja a necessidade de ordenação em ordem decrescente, adicione um espaço em branco e o termo desc após o nome do atributo na URL:

Exemplo:

https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/yms/patio/entities/circuitQuestionnaireView?orderby=titulo+desc

Para utilizar mais de um atributo na ordenação, separe por vírgula:

Exemplo:

https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/yms/patio/entities/circuitQuestionnaireView?orderby=titulo+desc,pergunta

Busca de registros com filtro

Ao efetuar uma chamada HTTP GET para uma entidade gerada, por padrão, são retornados todos os registros da entidade. Porém, é possível passar um filtro para restringir os registros retornados.

Exemplo:

https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/yms/patio/entities/circuitQuestionnaireView?filter=id ge 100 and id le 1000

O exemplo acima retorna todos os registros da entidade circuitQuestionnaireView cujos IDs estiverem entre 100 e 1000 inclusive.

Exemplo:

https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/yms/patio/entities/circuitQuestionnaireView?filter=titulo eq ‘caminhão ok?’ and containing(upper(resposta), upper(‘ok’))

Já esse exemplo, retorna todos os registros da entidade circuitQuestionnaireView onde o título for igual a caminhão ok? e a resposta (atributo resposta) contiver o texto ok. Perceba o uso da função upper (converte o texto para maiúsculo) que torna a busca no atributo resposta case insensitive.

Abaixo é apresentada uma tabela contendo os operadores e funções suportados pela busca com filtro:

Operador	Descrição	Exemplo
eq	= (igual)	?filtrer=id eq 10
ne	<> (diferente)	?filtrer=id ne 10
lt	< (menor que)	?filtrer=id lt 10
gt	> (maior que)	?filtrer=id gt 10
le	<= (menor ou igual)	?filtrer=id le 10
ge	>= (maior que)	?filtrer=id ge 10
is [not]	Verifica se parâmetro é nulo	?filtrer=id is null
containing	Contendo valor da direita no atributo da esquerda	?filtrer=containing(name, 'albert')
upper	Função da caixa alta	?filtrer=containing(upper(name), upper('Albert'))
and	E	?filtrer=id eq 10 and status eq 'y'
or	Ou	?filtrer=id eq 10 or id eq 20

Para mais informações sobre API, acesse Integração via API

Comando Enviar e-mail

Ao adicionar o comando Enviar e-mail, é aberta a tela Pré-visualização sem nenhum valor preenchido. Para configurar, clique em qualquer campo nesta tela, que, na sequência abrirá o Modo de edição, permitindo editar os campos Para (e-mail do destinatário), Assunto e Mensagem.

É possível utilizar as variáveis especiais para personalizar a mensagem. Essas variáveis são exibidas em Variáveis disponíveis, logo abaixo da Mensagem.

Para adicionar uma variável especial ao corpo da mensagem, digite o sinal {{. A partir disso, será aberta uma caixa de sugestão, onde você poderá selecionar a variável desejada com um clique.

Após configurar, quando a agenda atingir esse ponto durante a execução do circuito, o e-mail será enviado automaticamente conforme as configurações realizadas.

Comando Capturar Foto

O comando Capturar Foto aciona a câmera do dispositivo para tirar uma imagem e armazená-la ou usá-la no sistema.

Para sistemas terceiros é possível a captura de fotos em situações onde a conexão com o servidor é instável ou temporariamente indisponível. Desta forma, permite a captura e o armazenamento fotos localmente, e posteriormente enviá-las quando a conexão for restabelecida, garantindo que o fluxo do circuito não seja interrompido por problemas de conectividade.

Na configuração do comando no circuito, a opção Aceitar foto offiline fica disponível para uso.

O funcionamento da funcionalidade depende da habilitação do feature toggle featureCameraEscrava no ambiente. Quando habilitado, o sistema verificará se existem fotos offline disponíveis antes de tentar capturar uma nova foto.

O sistema terceiro deve:

Detectar quando está offline
Capturar e armazenar as fotos localmente
Detectar quando a conexão é restabelecida
Enviar as fotos armazenadas utilizando o endpoint sendOfflineSnapshot

PORTAL DE DOCUMENTAÇÃO
Gestão de Pátio \| YMS